home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / hunt100.zip / HUNT.DOC < prev   
Text File  |  1991-11-15  |  18KB  |  489 lines
  1.  
  2.         HUNT.ASP Hunt dialer for Procomm+
  3.         Introduction
  4.  
  5.  
  6.  
  7.         Procomm+ 2.xx is a terrific comm program and I wouldn't trade it
  8.         for the world.  Of course,  no program is perfect for everyone,
  9.         and Procomm+ is no exception.  One thing I always wanted was the
  10.         ability to dial multiple numbers from a single dialing directory
  11.         entry.   Why?  Just because I didn't like my dialing directory
  12.         cluttered up with 5 entries for the same BBS.  So,  thanks to
  13.         Datastorm's very powerful script langauge,  HUNT was born.  And
  14.         since scripts are now compiled,  I thought I'd waste a few
  15.         microseconds and add a few other niceties.
  16.  
  17.         Basically,  HUNT is a script that works together with Procomm's
  18.         dialing directory.  It will dial up to nine different numbers
  19.         from one entry and keep dialing until a modem answers.  When a
  20.         modem answers,  it will (optionally) open a log file and chain to
  21.         a user specified script.
  22.  
  23.         NOTE!!!!   HUNT is designed to work with a modem that uses the
  24.         Hayes AT command set.   If yours does not,  you will have to edit
  25.         HUNT.ASP to supply the equivalent commands and responses for your
  26.         modem.  Most of the commands are taken from Procomm's
  27.         configuration or supplied in a configuration file.  However,  the
  28.         script expects the modem the to respond with "OK" to
  29.         configuration commands.   It also expects verbal "CONNECT"
  30.         responses.   If your modem fits this description, you should have
  31.         little problem.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.         November 15, 1991                                     page 1
  62.  
  63.         HUNT.ASP Hunt dialer for Procomm+
  64.         INSTALLATION
  65.  
  66.  
  67.  
  68.  
  69.         Installation is simple,  just copy HUNT.ASP to the disk or
  70.         directory where you keep the rest of your script files,  either
  71.         the current DOS directory or the directory pointed to by the
  72.            set PCPLUS=~~~~ environment variable.  HUNT should run as is
  73.         on MOST systems,  but there are a few defaults you can change to
  74.         suit your system/preference.  You will also need to set up a
  75.         configuration file for each dialing directory entry you will use
  76.         with HUNT.
  77.  
  78.         To change HUNT's defaults,  call up HUNT.ASP in your favorite
  79.         ASCII editor.  Datastorm's PCEDIT,  MS-DOS 5.0's EDIT,  and (my
  80.         personal favorite) SemWare's Qedit,  will all work fine.  Near
  81.         the top of this file you will find the following variables:
  82.  
  83.         string configdir = ""
  84.         integer cnorm = 31
  85.         integer cerr  = 79
  86.         integer cwin  = 30
  87.  
  88.         integer RingWait = 5
  89.  
  90.         The first four can only be changed by editing HUNT.ASP.  The rest
  91.         can be changed through the configuration file and are discussed
  92.         in that section.  For those variables,  the values provided here
  93.         act as defaults.
  94.  
  95.         CONFIGDIR
  96.         This should contain the directory where you will keep your .HNT
  97.         and/or .NOT configuratiion files.  The default is blank,  which
  98.         means the DOS directory you are logged into when you start
  99.         Procomm+.  Note that HUNT does NOT look in the PCPLUS= directory
  100.         when searching for config files.  As an example,  I keep all my
  101.         config files in D:\COMM\DATA.  As such,  I have the following
  102.         line in HUNT.ASP:
  103.         configdir = "D:\DATA\COMM\"
  104.         The trailing "\" IS required.  Also note that if you use
  105.         Procomm's Jot command from dialing directory,  it will only look
  106.         in the current directory for the .NOT file.  If in doubt,  leave
  107.         it blank!
  108.  
  109.         CNORM CERR CWIN
  110.         These are the colors used by HUNT.ASP.  You may want to change
  111.         these if you have a monchrome monitor.  Of course,  you can also
  112.         change them to suit your taste.  CNORM is used to display
  113.         informational messages,  CWIN is the color of the dialing window,
  114.         and CERR is the color used for error messages.  the defaults are:
  115.         CNORM bright white on blue
  116.         CERR  bright white on red
  117.         CWIN  yellow on blue
  118.  
  119.  
  120.  
  121.  
  122.         November 15, 1991                                     page 2
  123.  
  124.         HUNT.ASP Hunt dialer for Procomm+
  125.         Using HUNT.ASP
  126.  
  127.  
  128.  
  129.         To use HUNT,  set it up as described in INSTALLATION.  Then,  for
  130.         each dialing directory entry you want to use HUNT with,  do the
  131.         following:
  132.  
  133.           1] Bring up the Procomm dialing directory.  ALT-D
  134.  
  135.           2] Use the cursor keys to highlight the entry to change
  136.              and press "r" to change the entry.  You'll see a screen
  137.              like this:
  138.              /-| Revise Entry 8|---------------------\
  139.              |        NAME: Flint Hills              |
  140.              |      NUMBER: pcboard      <------------  script to run when connected
  141.              |        BAUD: 38400                    |
  142.              |      PARITY: NONE                     |
  143.              |   DATA BITS: 8                        |
  144.              |   STOP BITS: 1                        |
  145.              |      DUPLEX: FULL                     |
  146.              |        PORT: DEFAULT                  |
  147.              |      SCRIPT: HUNT         <------------ required
  148.              |    PROTOCOL: YMODEM-G                 |
  149.              |    TERMINAL: ANSI                     |
  150.              |        MODE: DIRECT       <------------ required
  151.              |    PASSWORD:                          |
  152.              |   META FILE:                          |
  153.              |    KBD FILE:                          |
  154.              |   NOTE FILE: FHILLS       <------------ required config file name
  155.              \---------------------------------------/
  156.              You will need to change the following:
  157.              NUMBER:  HUNT will dial the numbers you specify in the
  158.                       config file,  so we use this entry to name the
  159.                       script you want to run when a connection is
  160.                       made.  Generally,  this will be whatever you
  161.                       had under SCRIPT, before.  This is optional and if
  162.                       not used,  it must be left blank
  163.  
  164.              SCRIPT:  This must be HUNT.
  165.  
  166.              MODE:    set to DIRECT.  This will prevent Procomm from
  167.                       trying to establish a connection before running
  168.                       HUNT.
  169.  
  170.              NOTE FILE: The name (without the . extension) of the file
  171.                       the contains the configuration info for this entry.
  172.                       HUNT will look first for a file having this name
  173.                       and an extension of.HNT.  If that cannot be found,
  174.                       it will look for a file with this name and an
  175.                       extension of .NOT (Procomm's default for a note
  176.                       file).
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.         November 15, 1991                                     page 3
  184.  
  185.         HUNT.ASP Hunt dialer for Procomm+
  186.         The Configuration File(s)
  187.  
  188.  
  189.  
  190.         This is where we keep the information the BBS you are calling.
  191.         In general,  you should have one configuration file for each
  192.         dialing directory you use with HUNT.ASP.   This file will contain
  193.         the phone numbers and the configuration paramaters for the BBS
  194.         you are calling.   Configuration files must have the extension
  195.         of .HNT or .NOT,  and MUST be located in the current directory,
  196.         or in the directory specified by the "configdir" variable
  197.         mentioned in the installation section.
  198.  
  199.         If you use the .NOT extension and locate the file in the current
  200.         directory,  you can use the Jot command from the dialing
  201.         directory to create/change the configuration file.  This is the
  202.         recommended setup and HUNT has some features that make this setup
  203.         as painless as possible.  Read on.
  204.  
  205.         When HUNT starts up,  it will perform the following steps to
  206.         locate a configuration file (using the above directory entry as
  207.         an example):
  208.  
  209.         Prepend "configdir" value to "NOTE FILE:" value and append ".HNT"
  210.         and look for "FHILLS.HNT"  (remember,  by default "configdir" is
  211.         blank)
  212.  
  213.         IF not found:
  214.         Prepend "configdir" value to "NOTE FILE:" value and append ".NOT"
  215.         and look for "FHILLS.NOT"
  216.  
  217.         IF not found:
  218.         display error message and exit.
  219.  
  220.         When HUNT finds the configuration file,  it processes it and if
  221.         all goes well,  begins the dialing sequence.  If no phone numbers
  222.         were found in the configuration file,  it will complain and exit.
  223.         HUNT displays each line of the file on your screen as it reads
  224.         them.   This helpful in debugging configurations and can also be
  225.         used to display a reminder when calling.   HUNT does NOT wait at
  226.         the end of screen,  but instead clears the screen from line 3 and
  227.         continues.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.         November 15, 1991                                     page 4
  245.         HUNT.ASP Hunt dialer for Procomm+
  246.         The Configuration File(s)
  247.         Configuration File Format
  248.  
  249.  
  250.  
  251.         Please refer to the sample configuration file (FHILLS.NOT) for
  252.         this section.
  253.  
  254.         The very first line of the file must contain the string #HUNT
  255.         somewhere between column 1 and column 80.  If HUNT does not find
  256.         this string,  it will complain and exit.   This is to prevent
  257.         HUNT from needlessly reading through a bogus file.
  258.  
  259.         The remaining lines consist of a command in columns 1 thru 3;  a
  260.         seperator in column 4 (any character may be used); and a command
  261.         argument in columns 5 thru 80.  This is known as a positional
  262.         format.  It isn't flexible,  but it's quick and easy to implement
  263.         (hey come on,  this IS a free program!!).
  264.  
  265.         Any line that contains a "#" in column 1 is considered a comment
  266.         and is ignored.  Lines containing invalid commands are also
  267.         ignored.
  268.  
  269.         The folling commands are available:
  270.         Any commands that are not specified in this file will use the
  271.         default values listed below.  Some of these are the defaults you
  272.         specify in Procomm's setup menus.  These are denoted by "Defaults
  273.         to Procomm's value".  Refer to your Procomm manual for more info.
  274.  
  275.         NOTE: "string" denotes an alphanumeric argument
  276.               "##" denotes a numeric argument
  277.               "none" indicates that no argument is used
  278.  
  279.         n1  string
  280.         n2  string
  281.         n3  string
  282.         n4  string
  283.         n5  string
  284.         n6  string
  285.         n7  string
  286.         n8  string
  287.         n9  string
  288.            These are the phone numbers to be dialed.   They are dialed in
  289.            numeric sequence,  n1, n2, etc.  The format of the number
  290.            depaends on your modem.  Most modems will ignore dashes and
  291.            underlines.   Numbers are passed to your modem exactly as you
  292.            enter them here and may contain any special characters that
  293.            your modem recognizes.  No default.
  294.  
  295.         mi  string
  296.            Modem initialization string.  This is a command sent to your
  297.            modem when HUNT first starts up.  By default,  this is set to
  298.            whatever value you put in Procomm's modem setup screen.  You
  299.            can overide that here,  but it really shouldn't be necessary.
  300.  
  301.         ms  string
  302.            Modem setup string.  This is a modem command sent after the
  303.  
  304.  
  305.         November 15, 1991                                     page 5
  306.         HUNT.ASP Hunt dialer for Procomm+
  307.         The Configuration File(s)
  308.         Configuration File Format
  309.  
  310.  
  311.  
  312.            initialization string.  This allows you to automatically
  313.            enable/disable special modem options on a per BBS basis.  For
  314.            example,  if you want to disable data compression on a Hayes
  315.            compatible MNP modem you could enter AT&K0 here.  Essentially,
  316.            you can put any commands here to deviate from your noral modem
  317.            settings.  No default.
  318.  
  319.         cw  ##
  320.            The number of seconds to wait for a response from your modem
  321.            after issuing the dial command.  Defaults to Procomm's value.
  322.  
  323.         rw  ##
  324.            The number of rings to wait before trying the next number.
  325.            This is valid only if your modem returns a RING result code.
  326.            Default is 5.
  327.  
  328.         log string
  329.            If desired,  HUNT will automatically open a log file when it
  330.            makes a connection.  "string" must be a valid DOS file name.
  331.            No default (no log file will be opened).
  332.  
  333.         spd ##
  334.            Here's one that BBS sysop's will probably hate me for.  This
  335.            tells HUNT to hangup if a connection is made at a speed less
  336.            than ##.   For example,  spd 9600 would cause HUNT to hangup
  337.            if a connection was made at say 2400 baud.  HUNT would then
  338.            continue as if no connection was made.  HUNT's speed detection
  339.            is a bit klutzy,  it determines the connect speed based on the
  340.            modem's connect message, ie. CONNECT 1200, CONNECT 9600, etc.
  341.            If HUNT cannot determine the speed from the connect message,
  342.            it will assume the speed to be whatever you have in your
  343.            dialing directory entry.
  344.            Default 300.
  345.  
  346.         end none
  347.            This tells HUNT to stop processing the configuration file.
  348.            When HUNT encounters this command,  it will immediately close
  349.            the config file and continue on its merry way.  Obviously,
  350.            this should be the very last command you use.  This allows you
  351.            to use your config file to store notes or even use it as a log
  352.            file.  In this way you can use your .NOT files as both a HUNT
  353.            config file and a note file.   (I told you we made it as
  354.            painless as possible!)
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.         November 15, 1991                                     page 6
  367.         HUNT.ASP Hunt dialer for Procomm+
  368.         Legal Tripe
  369.  
  370.  
  371.  
  372.  
  373.         DISCLAIMER:  This software is distibuted as is.   No warranties
  374.         are expressed or implied.
  375.  
  376.         FEES: No fees are applicable to this program.  It is distibuted
  377.         free of charge to anyone who wants to use it.  You may freely
  378.         copy and distribute it provided you do so in it's orginal form
  379.         and charge no fee for the software itself.
  380.  
  381.         CREDITS:
  382.         Procomm+ is a trademark of Datastorm Technologies, Inc.
  383.         MS-DOS   is a trademark of Microsoft Corporation.
  384.         Qedit    is a trademark of Applied Systems Technologies, Inc.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.         Please send questions,  comments,  bug reports to:
  391.                               Larry McElderry
  392.                               P.O.Box 1172
  393.                               Manhattan, KS  66502
  394.                               Compuserve ID: 74017,1630
  395.                       Also available at EXEC-PC
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.         November 15, 1991                                     page 7
  428.         HUNT.ASP Hunt dialer for Procomm+
  429.         HISTORY
  430.  
  431.  
  432.  
  433.  
  434.         version 1.00  initial release
  435.           Caveats: The dialing is somewhat clumsy.  The design intent was
  436.                    that pressing <spacebar> would cycle to the next
  437.                    number,  and pressing <ESC> would cancel the script.
  438.                    It does work this way,  but not always with the most
  439.                    convenient timing.  For version 2 I'm looking into
  440.                    replacing a lot of the script with a "hook" program.
  441.  
  442.                    Since we tell Procomm that this is a direct
  443.                    connection,  it thinks a connection is made every time
  444.                    you dial.  As a result,  an entry is made in the call
  445.                    log file,  and if this is one of multiple entries that
  446.                    you marked for dialing,  the sequence will stop here.
  447.                    Also,  the last call date and number of calls will be
  448.                    updated at the time the entry is picked from the
  449.                    directory.   Call duration will also begin at that
  450.                    point.
  451.  
  452.                    The ATE0 command to disable local echo from the modem
  453.                    is hard coded and VERY important.  Without it the rget
  454.                    commands will respond to the modem's echo and the
  455.                    script will fail miserably.  As such,  the script will
  456.                    abort if the modem does not say "OK" when issued this
  457.                    command.  If the command to disable local echo is
  458.                    something different for your modem,  you will need to
  459.                    change this.
  460.  
  461.                    Finally,  the "spd" command should be used with
  462.                    caution.  Only the more popular baud rates are
  463.                    supported (14400, 9600, 2400, 1200) and even these
  464.                    require that the modem return the proper values in
  465.                    it's connect message.  Of course you can modify this
  466.                    by changing the DOCONNECT proc.  Also note that these
  467.                    speeds refer to line speed,  not necessarily DTE
  468.                    speed.  This too could be enhanced with a hook.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.         November 15, 1991                                     page 8
  489.